home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr47 / wasm223.zip / WARP.DOC < prev    next >
Text File  |  1993-05-04  |  10KB  |  235 lines
  1.  
  2.  
  3.  
  4.                                    Warp Driver
  5.                               A Fast Console Device
  6.  
  7.                                        by
  8.  
  9.                                    Eric Tauck
  10.                                1304 Deerpass Road
  11.                                 Marengo, IL 60152
  12.                                      U.S.A.
  13.  
  14.                              Compuserve: 72457,1557
  15.                        Internet: 72457.1557@compuserve.com
  16.  
  17.         Warp is a device driver for speeding up standard output.  Addi-
  18.         tional features of Warp include auto-pause, a shortened BIOS
  19.         beep, and partial ANSI support.  Warp requires a PC/XT/AT compat-
  20.         ible and DOS 2.0 or higher.
  21.  
  22.         Warp may be used and distributed freely.  The most recent version
  23.         of Warp is available on 5.25" or 3.5" disk by sending $10 to the
  24.         address above.  The WASM compatible source code is available for
  25.         $50.  The source code is for personal use and may not be distrib-
  26.         uted.
  27.  
  28.         The file WARP.SYS is the standard Warp device driver.  The file
  29.         WARPF.SYS is a faster version of the driver.  If WARP.SYS doesn't
  30.         seem to speed up your display, try using WARPF.SYS.  A side
  31.         effect of WARPF.SYS is that the cursor may not be positioned
  32.         correctly until the system expects you to type something.  The
  33.         program WARP.COM is a utility to reconfigure WARP.SYS or
  34.         WARPF.SYS after they have been installed.
  35.  
  36.         Warp is installed by placing the following line in your
  37.         CONFIG.SYS file:
  38.  
  39.           DEVICE=WARP.SYS [switches]
  40.  
  41.           or
  42.  
  43.           DEVICE=WARPF.SYS [switches]
  44.  
  45.         The possible switches are:
  46.  
  47.           /E    Enable auto-pause.  This is the default.
  48.  
  49.           /D    Disable auto-pause.
  50.  
  51.           /C:x  Set the output color to x.  This value is an attribute
  52.                 byte in the range 0 to 255.  You can also set the color
  53.                 with an ANSI sequence described later in this document.
  54.                 The default is 7 (white on black).
  55.  
  56.  
  57.  
  58.           /P    Set the auto-pause prompt to the output color.  This is
  59.                 the default.  You can set the prompt color to something
  60.                 other than the output color with the switch below.
  61.  
  62.           /P:x  Set the auto-pause prompt color to x.  This value is an
  63.                 attribute byte in the range 0 to 255.
  64.  
  65.         The color values for the /C and /P switches are:
  66.  
  67.             1  blue foreground
  68.             2  green foreground
  69.             3  cyan foreground
  70.             4  red foreground
  71.             5  magenta foreground
  72.             6  brown foreground
  73.             7  white foreground
  74.  
  75.            16  blue background
  76.            32  green background
  77.            48  cyan background
  78.            64  red background
  79.            80  magenta background
  80.            96  brown background
  81.           112  white background
  82.  
  83.         Add a foreground and background color value together to calculate
  84.         an attribute byte.  If a foreground or background value are
  85.         omitted, the foreground or background color will be black.  Add 8
  86.         to the value to make the foreground color brighter.  Add 128 to
  87.         the value to make the foreground blink.
  88.  
  89.         If you want to change any of the switch setting after you have
  90.         installed Warp, use the utility WARP.COM.  WARP.COM accepts the
  91.         same switches as WARP.SYS and WARPF.SYS, and will pass the
  92.         switches to the resident driver.
  93.  
  94.         The Warp auto-pause feature works like the MORE utility included
  95.         with DOS.  After an entire screen of output, Warp displays the
  96.         message "Press any key to continue ..." and waits for a key to be
  97.         pressed.  The auto-pause feature is only enabled when scroll-lock
  98.         is active.  The auto-pause feature can also be disabled regard-
  99.         less of the scroll-lock state with the /D switch.  Make sure you
  100.         turn off scroll-lock (or disable the auto-pause feature) before
  101.         running programs unattended, unless you want the screen to pause
  102.         when you're not there.  If you press the ESC key when the screen
  103.         is paused, the auto-pause feature will be disabled until the next
  104.         time you enter a DOS command.
  105.  
  106.         Warp automatically generates a shorter and less annoying beep
  107.         than produced by DOS or BIOS.  This is done by hooking interrupt
  108.         10H and trapping all ASCII code 7's sent to the BIOS TTY func-
  109.         tion.  Only a few, mostly older, applications will be affected by
  110.         this.
  111.  
  112.         Warp's ANSI support is limited to clear screen, move cursor, and
  113.  
  114.  
  115.  
  116.         set color.  The specific ANSI sequences supported are as follows:
  117.  
  118.           ESC[2J            clear screen and home cursor
  119.           ESC[K             clear from cursor to end of line
  120.           ESC[#;#f          move cursor
  121.           ESC[#;#H          move cursor
  122.           ESC[#A            move cursor up
  123.           ESC[#B            move cursor down
  124.           ESC[#C            move cursor right
  125.           ESC[#D            move cursor left
  126.           ESC[s             save cursor location
  127.           ESC[u             restore cursor location
  128.           ESC[#;...;#m      set colors
  129.  
  130.         All ANSI sequences begin with ESC (ASCII code 27) and '[' (ASCII
  131.         code 91).  The # in the sequences refer to decimal numbers.  The
  132.         two numbers in the 'f' and 'H' sequences are the row and column
  133.         location.  The single number in the 'A' through 'D' sequences are
  134.         the number of rows or columns to move.  The cursor movement
  135.         numbers default to 1 if they are absent.  The numbers in the 'm'
  136.         sequence affect the screen colors as follows:
  137.  
  138.            0  all attributes off (white on black)
  139.            1  bold on
  140.            4  underscore (monochrome adapters only)
  141.            5  blink on
  142.            7  reverse video (black on white)
  143.            8  concealed (black on black)
  144.           30  black foreground
  145.           31  red foreground
  146.           32  green foreground
  147.           33  yellow foreground (usually mapped to brown)
  148.           34  blue foreground
  149.           35  magenta foreground
  150.           36  cyan foreground
  151.           37  white foreground
  152.           40  black background
  153.           41  red background
  154.           42  green background
  155.           43  yellow background (usually mapped to brown)
  156.           44  blue background
  157.           45  magenta background
  158.           46  cyan background
  159.           47  white background
  160.  
  161.         Warp should work in all text modes.  In graphics modes, Warp
  162.         passes output to the BIOS.  Auto-pause and ANSI support is disa-
  163.         bled in graphics modes.
  164.  
  165.         Though the ANSI sequence to clear the screen works in all text
  166.         modes when using MS DOS 4.01 on my system, the CLS command
  167.         doesn't completely work (it only clears the first 25 lines in the
  168.         greater than 25 line modes and does not use the current color).
  169.         I think this is because this version of DOS calls the to BIOS to
  170.         clear the screen, rather than using the device driver.  If you
  171.  
  172.  
  173.  
  174.         have this sort of problem, you could clear the screen by display-
  175.         ing the clear screen ANSI sequence, for instance by ECHOing
  176.         ESC[2J (the ESC must be the actual character with ASCII code 27).
  177.  
  178.         Compatibility considerations:
  179.  
  180.           * Warp never waits for "vertical retrace" when displaying
  181.             characters, which may cause snow on CGA monitors.
  182.  
  183.           * WARP.SYS (but not WARPF.SYS) positions the cursor by directly
  184.             modifying the video controller ports.  This may not work on
  185.             nonstandard video systems and could cause problems in some
  186.             operating environments.
  187.  
  188.           * The length of the beep may be irregular under multi-tasking
  189.             systems, like Windows or Desqview.
  190.  
  191.           * Warp uses the undocumented (but widely recognized) interrupt
  192.             29H.
  193.  
  194.         Version changes:
  195.  
  196.           1.00  Original release.
  197.  
  198.           1.01  Traps INT 1B and ignores code 00/00 from INT 16.
  199.  
  200.           1.10  Added /P:n option and cleaned up code.
  201.  
  202.           2.00  Improved ANSI support, improved auto-pause, allow config-
  203.                 uration after installation, and changed switches.  The
  204.                 auto-pause feature will no longer work with an arbitrary
  205.                 number of lines.
  206.  
  207.           2.01  Default prompt color is no longer green.
  208.  
  209.           2.02  Command error message and parsing bugs fixed in WARP.SYS
  210.                 and WARPF.SYS.  Beep routines partially rewritten.
  211.  
  212.           2.10  The ESC key temporarily disables the auto-pause and the
  213.                 special Paradise text modes 54 to 57 (hex) are recog-
  214.                 nized.
  215.  
  216.           2.11  Fixed the order of the row and column arguments for the H
  217.                 and f ANSI sequences (they were reversed).
  218.  
  219.                              DISCLAIMER OF WARRANTY
  220.  
  221.         THIS SOFTWARE AND MANUAL ARE DISTRIBUTED "AS IS" AND WITHOUT
  222.         WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER
  223.         WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE OF THE VARIOUS
  224.         HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE
  225.         PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.
  226.  
  227.         GOOD DATA PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM BE
  228.         THOROUGHLY TESTED WITH NON-CRITICAL DATA BEFORE RELYING ON IT.
  229.  
  230.  
  231.  
  232.         THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY
  233.         LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT
  234.         REPLACEMENT OR REFUND OF PURCHASE PRICE.
  235.